Visual Studio CodeでPythonの開発環境構築を構築してみた。

梶原裕

2016.10.05

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

好物はインフラとフロントエンドのかじわらゆたかです。
Pythonを開発するケースが出てきたので、O/S問わずに使えるVisual Studio Codeで環境を構築してみました。
目標としては、IntelliSenseが動くこと、Code Formatができること、Lintが動くこと、
pyenv環境のPythonが指定できること、Debugができること、
この辺りを調べてみたいと思います。

環境

OS : OSX El Capitan (10.11.4)
Visual Studio Code : 1.5.2
Python : pyenv pyenv-virtualを用いてのバージョン切り替えを実施
- 参考: pyenv 利用のまとめ - Qiita

導入方法

導入の手順としては、以下のような流れになります。

PythonのVisual Studio Code拡張を導入する。
Pythonの環境を構築する。
プロジェクト用のディレクトリを作成し、作成したディレクトリをVisual Studio Codeから開く

Python用の拡張機能を導入

Python with Visual Studio Codeをもとに進めていきます。
拡張機能は複数あるようですが、ダウンロード数を多いPython - Visual Studio Marketplaceを選択しました。　　

Pythonの環境を構築する。

環境で記載したQiitaのPyenv導入の流れと同様になります。
* 参考: pyenv 利用のまとめ - Qiita

プロジェクト用のディレクトリを作成し、作成したディレクトリをVisual Studio Codeから開く

適当なディレクトリを作成し、そこにpythonの2.7.11を元としたVirtual Envを作成していきます。

mkdir pythonProject
cd pythonProject
pyenv virtualenv 2.7.11 projectStudy
pyenv local projectStudy
code ./

上記の最終行のcodeですが、これはターミナルからVisual Studio Codeを起動する。を有効にすることで扱えるようになるコマンドになります。
Visual Studio CodeによるRubyのデバッグ｜ Developers.IO

Intellisenceの挙動確認

新しいPythonファイルを作成し、入力してくなかで該当する関数があれば、候補として表示されます。
なお、候補の確定はTabキーを押下することで確定となるようです。
python01

次に追加でライブラリを追加し、追加したライブラリの関数が補完されるか確認してみたいと思います。
題材としては、Amazon Web Services (AWS) SDK for Pythonであるboto3を対象としてみます。

当然、デフォルトの状態ではboto3は導入されていないので、自動補完の対象にも含まれておりません。 python02

ViewからIntegrated Terminalを表示させて、以下の用に入力しboto3を導入します。

pip install boto3

その後自動補完でboto3が含まれていることが確認できます。 python03

python04

Lintの確認

ソースファイルの記載の揺れ等を抑制するためにLintツールを用いる事はよくあることですが、
Pythonには実に様々なLintのツールが存在します。
Visual Studio CodeのPython拡張はPylint,Pep8,Flake8に対応しています。
Linting · DonJayamanne/pythonVSCode Wiki

今回はFlake8でLintを行なってみたいと思います。
Visual Studio CodeのPython拡張でFlake8を用いる場合、Flake8がPythonのライブラリとして入っている必要があります。導入は先ほどのboto3と同様です。

pip install flake8

次にflake8を用いる設定を行います。
Code　→　WorkspaceSettingで以下のように記載します。

Settings.json

{
    "python.linting.flake8Enabled": true
}

この拡張の仕様なのかWorkspaceSettingの内容はフォルダを開いたときに読み込まれるといった挙動をしたので、
この段階で作業対象のフォルダを開き直します。

次にLintで引っかかるようなPythonスクリプトを作成し、保存しようとした際にLintでのチェックが入ります。
以下のような例ですと、7箇所Lintでエラーと警告が出るはずです。

LintTarget.py

　　
　　
import sys  # 余分な import
import os
def fib():
    x = 0  # 使ってない変数
    a, b = 1, 1


    while True:
        yield    a    # 余分なスペース
        a, b = b, a + b


if __name__ == '__main__':
    for i, num in enumerate(fib()):
        print(num)
        if i >= 9:
            break

python05

参考 Python の Lint (文法チェッカ) まとめ - flake8 + hacking を使う - - Qiita

Code Formatの挙動確認

Lintで警告になる内容として、不要な改行といった内容も含まれます。
そういった内容に関しては、CodeFormatterで対応してしまおうと思います。
Visual Studio CodeのPython拡張はCode Formatterとして、AutoPep8,Yapfに対応しています。

今回はYapfを用いたCode Formatを実施してみたいと思います。

導入手順としてはLintと同様です。
ライブラリの導入を行い、設定ファイルに使う旨を記載します。

pip install yapf

Settings.json

{
    "python.linting.flake8Enabled": true,
    "python.formatting.provider": "yapf"
}

Visual Studio Codeを再起動させて、先ほどのフォルダ・ファイルを開いてみます。
先ほどと同じく7個のエラーが出ていると思います。
この状態でコードを全選択し、右クリックからFormat Codeを選択します。 python06

コードの整形が実施されるので、ファイルを保存します。
Lintが実施され先ほど７つ出ていたエラーが４つに減っていることがわかります。
python07

残っている警告は不使用な関数やImport式と最終行が空白で終わっていないといった内容となります。
それらを対応することでLintの警告を無くすことが可能です。

Debugの実施

Debugの環境構築については、以前Rubyでやったのとほぼ同一になります。
ですが、以前は手動で書いていたLaunch.jsonを自動で生成してくれるので、その方法を紹介します。
Debugのビューを開き、Configure or Fix 'Launch.json'を選択すると、Launch.jsonの雛形を選べる様になっています。
今回はもちろんPythonを選択します。
python08